logo

وب سرویس استعلام اتباع خارجی؛

سرویس «استعلام اتباع خارجی» در دسته احراز هویت و شناخت مشتری فینوتک، با گرفتن شناسه تبعه و تاریخ تولد، اطلاعات هویتی فرد شامل نام و نام خانوادگی، نام پدر، نام جد، جنسیت، ملیت و مشخصات سند شناسایی او را برمی‌گرداند

سرویس «استعلام اتباع خارجی» در دسته احراز هویت و شناخت مشتری فینوتک، با گرفتن شناسه تبعه و تاریخ تولد، اطلاعات هویتی فرد شامل نام و نام خانوادگی، نام پدر، نام جد، جنسیت، ملیت و مشخصات سند شناسایی او را برمی‌گرداند. با این خروجی می‌توانید هویت مشتری غیرایرانی را پیش از ارائه خدمت، بدون اتکا به تصویر مدرک، راستی‌آزمایی کنید.

چرا وب سرویس استعلام اتباع خارجی؟

احراز هویت اتباع خارجی در بیشتر کسب‌وکارها هنوز فرآیندی کاغذی است: مشتری تصویر کارت یا برگه اقامت را می‌آورد، کارشناس آن را نگاه می‌کند و اطلاعات را دستی در سامانه وارد می‌کند. در این مسیر، هم خطای تایپ در نام و ملیت زیاد است، هم امکان تشخیص مدرک نامعتبر عملا وجود ندارد، و هم فرآیند پذیرش مشتری چند روز طول می‌کشد. برای کسب‌وکارهایی که موظف‌اند سوابق هویتی قابل دفاع نگه دارند، این روش ریسک انطباق ایجاد می‌کند.

  • پذیرش مشتری غیرایرانی در خدمات مالی و پرداخت — هویت متقاضی پیش از فعال‌سازی حساب کاربری یا کیف پول با داده ساخت‌یافته بررسی می‌شود.

تست فوری API استعلام اتباع خارجی

جزئیات ورودی، خروجی و نمونه پاسخ در مستندات فنی آمده است.

1curl --location --request GET 'https://apibeta.finnotech.ir/kyc/v2/clients/TestFn/foreignerIdInquiry?trackId=trackId&foreignerId=%7BforeignerId%7D&birthDate=1356%2F02%2F23' \2--header 'Authorization: Bearer ACCESS_TOKEN'

سوالات متداول

سرویسی است که با دریافت شناسه تبعه و تاریخ تولد، اطلاعات هویتی فرد غیرایرانی شامل نام، نام خانوادگی، نام پدر، نام جد، جنسیت، ملیت و مشخصات سند شناسایی او را به‌صورت داده ساخت‌یافته برمی‌گرداند.

ورودی این سرویس شناسه تبعه است و برای افراد غیرایرانی به کار می‌رود؛ برای افراد دارای کد ملی از استعلام اطلاعات هویتی استفاده کنید.

عنوان نوع سند شناسایی و شماره آن در پاسخ می‌آید. شرح دقیق خروجی در مستندات فنی آمده است.

بله؛ تاریخ تولد در کنار شناسه تبعه ورودی الزامی است و باید در قالب yyyy/mm/dd ارسال شود.

صفحه مشخصات API شامل endpoint، پارامترها و نمونه پاسخ است.

Grant type: client_credentials. جزئیات در راهنمای توکن.

خیر. این سرویس با Client Credential و بدون رضایت پیامکی قابل فراخوانی است.

Top

آیا می‌خواهید شروع کنید؟

این سرویس فقط به کسب‌وکارها ارائه می‌شود

ما به محقق شدن رؤیای شما کمک می‌کنیم